home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet bezpieczenstwa / mini Pentoo LiveCD 2006.1 / mpentoo-2006.1.iso / livecd.squashfs / usr / lib / python2.4 / tempfile.pyo (.txt) < prev    next >
Python Compiled Bytecode  |  2005-10-18  |  14KB  |  496 lines

  1. # Source Generated with Decompyle++
  2. # File: in.pyo (Python 2.4)
  3.  
  4. '''Temporary files.
  5.  
  6. This module provides generic, low- and high-level interfaces for
  7. creating temporary files and directories.  The interfaces listed
  8. as "safe" just below can be used without fear of race conditions.
  9. Those listed as "unsafe" cannot, and are provided for backward
  10. compatibility only.
  11.  
  12. This module also provides some data items to the user:
  13.  
  14.   TMP_MAX  - maximum number of names that will be tried before
  15.              giving up.
  16.   template - the default prefix for all temporary names.
  17.              You may change this to control the default prefix.
  18.   tempdir  - If this is set to a string before the first use of
  19.              any routine from this module, it will be considered as
  20.              another candidate location to store temporary files.
  21. '''
  22. __all__ = [
  23.     'NamedTemporaryFile',
  24.     'TemporaryFile',
  25.     'mkstemp',
  26.     'mkdtemp',
  27.     'mktemp',
  28.     'TMP_MAX',
  29.     'gettempprefix',
  30.     'tempdir',
  31.     'gettempdir']
  32. import os as _os
  33. import errno as _errno
  34. from random import Random as _Random
  35. if _os.name == 'mac':
  36.     import Carbon.Folder as _Folder
  37.     import Carbon.Folders as _Folders
  38.  
  39.  
  40. try:
  41.     import fcntl as _fcntl
  42. except ImportError:
  43.     
  44.     def _set_cloexec(fd):
  45.         pass
  46.  
  47.  
  48.  
  49. def _set_cloexec(fd):
  50.     
  51.     try:
  52.         flags = _fcntl.fcntl(fd, _fcntl.F_GETFD, 0)
  53.     except IOError:
  54.         pass
  55.  
  56.     flags |= _fcntl.FD_CLOEXEC
  57.     _fcntl.fcntl(fd, _fcntl.F_SETFD, flags)
  58.  
  59.  
  60. try:
  61.     import thread as _thread
  62. except ImportError:
  63.     import dummy_thread as _thread
  64.  
  65. _allocate_lock = _thread.allocate_lock
  66. _text_openflags = _os.O_RDWR | _os.O_CREAT | _os.O_EXCL
  67. if hasattr(_os, 'O_NOINHERIT'):
  68.     _text_openflags |= _os.O_NOINHERIT
  69.  
  70. if hasattr(_os, 'O_NOFOLLOW'):
  71.     _text_openflags |= _os.O_NOFOLLOW
  72.  
  73. _bin_openflags = _text_openflags
  74. if hasattr(_os, 'O_BINARY'):
  75.     _bin_openflags |= _os.O_BINARY
  76.  
  77. if hasattr(_os, 'TMP_MAX'):
  78.     TMP_MAX = _os.TMP_MAX
  79. else:
  80.     TMP_MAX = 10000
  81. template = 'tmp'
  82. tempdir = None
  83. _once_lock = _allocate_lock()
  84. if hasattr(_os, 'lstat'):
  85.     _stat = _os.lstat
  86. elif hasattr(_os, 'stat'):
  87.     _stat = _os.stat
  88. else:
  89.     
  90.     def _stat(fn):
  91.         
  92.         try:
  93.             f = open(fn)
  94.         except IOError:
  95.             raise _os.error
  96.  
  97.         f.close()
  98.  
  99.  
  100. def _exists(fn):
  101.     
  102.     try:
  103.         _stat(fn)
  104.     except _os.error:
  105.         return False
  106.  
  107.     return True
  108.  
  109.  
  110. class _RandomNameSequence:
  111.     '''An instance of _RandomNameSequence generates an endless
  112.     sequence of unpredictable strings which can safely be incorporated
  113.     into file names.  Each string is six characters long.  Multiple
  114.     threads can safely use the same instance at the same time.
  115.  
  116.     _RandomNameSequence is an iterator.'''
  117.     characters = 'abcdefghijklmnopqrstuvwxyz' + 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' + '0123456789-_'
  118.     
  119.     def __init__(self):
  120.         self.mutex = _allocate_lock()
  121.         self.rng = _Random()
  122.         self.normcase = _os.path.normcase
  123.  
  124.     
  125.     def __iter__(self):
  126.         return self
  127.  
  128.     
  129.     def next(self):
  130.         m = self.mutex
  131.         c = self.characters
  132.         choose = self.rng.choice
  133.         m.acquire()
  134.         
  135.         try:
  136.             letters = [ choose(c) for dummy in '123456' ]
  137.         finally:
  138.             m.release()
  139.  
  140.         return self.normcase(''.join(letters))
  141.  
  142.  
  143.  
  144. def _candidate_tempdir_list():
  145.     '''Generate a list of candidate temporary directories which
  146.     _get_default_tempdir will try.'''
  147.     dirlist = []
  148.     for envname in ('TMPDIR', 'TEMP', 'TMP'):
  149.         dirname = _os.getenv(envname)
  150.         if dirname:
  151.             dirlist.append(dirname)
  152.             continue
  153.     
  154.     if _os.name == 'mac':
  155.         
  156.         try:
  157.             fsr = _Folder.FSFindFolder(_Folders.kOnSystemDisk, _Folders.kTemporaryFolderType, 1)
  158.             dirname = fsr.as_pathname()
  159.             dirlist.append(dirname)
  160.         except _Folder.error:
  161.             pass
  162.         except:
  163.             None<EXCEPTION MATCH>_Folder.error
  164.         
  165.  
  166.     None<EXCEPTION MATCH>_Folder.error
  167.     if _os.name == 'riscos':
  168.         dirname = _os.getenv('Wimp$ScrapDir')
  169.         if dirname:
  170.             dirlist.append(dirname)
  171.         
  172.     elif _os.name == 'nt':
  173.         dirlist.extend([
  174.             'c:\\temp',
  175.             'c:\\tmp',
  176.             '\\temp',
  177.             '\\tmp'])
  178.     else:
  179.         dirlist.extend([
  180.             '/tmp',
  181.             '/var/tmp',
  182.             '/usr/tmp'])
  183.     
  184.     try:
  185.         dirlist.append(_os.getcwd())
  186.     except (AttributeError, _os.error):
  187.         dirlist.append(_os.curdir)
  188.  
  189.     return dirlist
  190.  
  191.  
  192. def _get_default_tempdir():
  193.     '''Calculate the default directory to use for temporary files.
  194.     This routine should be called exactly once.
  195.  
  196.     We determine whether or not a candidate temp dir is usable by
  197.     trying to create and write to a file in that directory.  If this
  198.     is successful, the test file is deleted.  To prevent denial of
  199.     service, the name of the test file must be randomized.'''
  200.     namer = _RandomNameSequence()
  201.     dirlist = _candidate_tempdir_list()
  202.     flags = _text_openflags
  203.     for dir in dirlist:
  204.         if dir != _os.curdir:
  205.             dir = _os.path.normcase(_os.path.abspath(dir))
  206.         
  207.         for seq in xrange(100):
  208.             name = namer.next()
  209.             filename = _os.path.join(dir, name)
  210.             
  211.             try:
  212.                 fd = _os.open(filename, flags, 384)
  213.                 fp = _os.fdopen(fd, 'w')
  214.                 fp.write('blat')
  215.                 fp.close()
  216.                 _os.unlink(filename)
  217.                 del fp
  218.                 del fd
  219.                 return dir
  220.             continue
  221.             except (OSError, IOError):
  222.                 e = None
  223.                 if e[0] != _errno.EEXIST:
  224.                     break
  225.                 
  226.                 e[0] != _errno.EEXIST
  227.             
  228.  
  229.         
  230.     
  231.     raise IOError, (_errno.ENOENT, 'No usable temporary directory found in %s' % dirlist)
  232.  
  233. _name_sequence = None
  234.  
  235. def _get_candidate_names():
  236.     '''Common setup sequence for all user-callable interfaces.'''
  237.     global _name_sequence
  238.     if _name_sequence is None:
  239.         _once_lock.acquire()
  240.         
  241.         try:
  242.             if _name_sequence is None:
  243.                 _name_sequence = _RandomNameSequence()
  244.         finally:
  245.             _once_lock.release()
  246.  
  247.     
  248.     return _name_sequence
  249.  
  250.  
  251. def _mkstemp_inner(dir, pre, suf, flags):
  252.     '''Code common to mkstemp, TemporaryFile, and NamedTemporaryFile.'''
  253.     names = _get_candidate_names()
  254.     for seq in xrange(TMP_MAX):
  255.         name = names.next()
  256.         file = _os.path.join(dir, pre + name + suf)
  257.         
  258.         try:
  259.             fd = _os.open(file, flags, 384)
  260.             _set_cloexec(fd)
  261.             return (fd, _os.path.abspath(file))
  262.         continue
  263.         except OSError:
  264.             e = None
  265.             if e.errno == _errno.EEXIST:
  266.                 continue
  267.             
  268.             raise 
  269.             continue
  270.         
  271.  
  272.     
  273.     raise IOError, (_errno.EEXIST, 'No usable temporary file name found')
  274.  
  275.  
  276. def gettempprefix():
  277.     '''Accessor for tempdir.template.'''
  278.     return template
  279.  
  280. tempdir = None
  281.  
  282. def gettempdir():
  283.     '''Accessor for tempdir.tempdir.'''
  284.     global tempdir
  285.     if tempdir is None:
  286.         _once_lock.acquire()
  287.         
  288.         try:
  289.             if tempdir is None:
  290.                 tempdir = _get_default_tempdir()
  291.         finally:
  292.             _once_lock.release()
  293.  
  294.     
  295.     return tempdir
  296.  
  297.  
  298. def mkstemp(suffix = '', prefix = template, dir = None, text = False):
  299.     """mkstemp([suffix, [prefix, [dir, [text]]]])
  300.     User-callable function to create and return a unique temporary
  301.     file.  The return value is a pair (fd, name) where fd is the
  302.     file descriptor returned by os.open, and name is the filename.
  303.  
  304.     If 'suffix' is specified, the file name will end with that suffix,
  305.     otherwise there will be no suffix.
  306.  
  307.     If 'prefix' is specified, the file name will begin with that prefix,
  308.     otherwise a default prefix is used.
  309.  
  310.     If 'dir' is specified, the file will be created in that directory,
  311.     otherwise a default directory is used.
  312.  
  313.     If 'text' is specified and true, the file is opened in text
  314.     mode.  Else (the default) the file is opened in binary mode.  On
  315.     some operating systems, this makes no difference.
  316.  
  317.     The file is readable and writable only by the creating user ID.
  318.     If the operating system uses permission bits to indicate whether a
  319.     file is executable, the file is executable by no one. The file
  320.     descriptor is not inherited by children of this process.
  321.  
  322.     Caller is responsible for deleting the file when done with it.
  323.     """
  324.     if dir is None:
  325.         dir = gettempdir()
  326.     
  327.     if text:
  328.         flags = _text_openflags
  329.     else:
  330.         flags = _bin_openflags
  331.     return _mkstemp_inner(dir, prefix, suffix, flags)
  332.  
  333.  
  334. def mkdtemp(suffix = '', prefix = template, dir = None):
  335.     """mkdtemp([suffix, [prefix, [dir]]])
  336.     User-callable function to create and return a unique temporary
  337.     directory.  The return value is the pathname of the directory.
  338.  
  339.     Arguments are as for mkstemp, except that the 'text' argument is
  340.     not accepted.
  341.  
  342.     The directory is readable, writable, and searchable only by the
  343.     creating user.
  344.  
  345.     Caller is responsible for deleting the directory when done with it.
  346.     """
  347.     if dir is None:
  348.         dir = gettempdir()
  349.     
  350.     names = _get_candidate_names()
  351.     for seq in xrange(TMP_MAX):
  352.         name = names.next()
  353.         file = _os.path.join(dir, prefix + name + suffix)
  354.         
  355.         try:
  356.             _os.mkdir(file, 448)
  357.             return file
  358.         continue
  359.         except OSError:
  360.             e = None
  361.             if e.errno == _errno.EEXIST:
  362.                 continue
  363.             
  364.             raise 
  365.             continue
  366.         
  367.  
  368.     
  369.     raise IOError, (_errno.EEXIST, 'No usable temporary directory name found')
  370.  
  371.  
  372. def mktemp(suffix = '', prefix = template, dir = None):
  373.     """mktemp([suffix, [prefix, [dir]]])
  374.     User-callable function to return a unique temporary file name.  The
  375.     file is not created.
  376.  
  377.     Arguments are as for mkstemp, except that the 'text' argument is
  378.     not accepted.
  379.  
  380.     This function is unsafe and should not be used.  The file name
  381.     refers to a file that did not exist at some point, but by the time
  382.     you get around to creating it, someone else may have beaten you to
  383.     the punch.
  384.     """
  385.     if dir is None:
  386.         dir = gettempdir()
  387.     
  388.     names = _get_candidate_names()
  389.     for seq in xrange(TMP_MAX):
  390.         name = names.next()
  391.         file = _os.path.join(dir, prefix + name + suffix)
  392.         if not _exists(file):
  393.             return file
  394.             continue
  395.     
  396.     raise IOError, (_errno.EEXIST, 'No usable temporary filename found')
  397.  
  398.  
  399. class _TemporaryFileWrapper:
  400.     '''Temporary file wrapper
  401.  
  402.     This class provides a wrapper around files opened for
  403.     temporary use.  In particular, it seeks to automatically
  404.     remove the file when it is no longer needed.
  405.     '''
  406.     
  407.     def __init__(self, file, name):
  408.         self.file = file
  409.         self.name = name
  410.         self.close_called = False
  411.  
  412.     
  413.     def __getattr__(self, name):
  414.         file = self.__dict__['file']
  415.         a = getattr(file, name)
  416.         if type(a) != type(0):
  417.             setattr(self, name, a)
  418.         
  419.         return a
  420.  
  421.     if _os.name != 'nt':
  422.         unlink = _os.unlink
  423.         
  424.         def close(self):
  425.             if not self.close_called:
  426.                 self.close_called = True
  427.                 self.file.close()
  428.                 self.unlink(self.name)
  429.             
  430.  
  431.         
  432.         def __del__(self):
  433.             self.close()
  434.  
  435.     
  436.  
  437.  
  438. def NamedTemporaryFile(mode = 'w+b', bufsize = -1, suffix = '', prefix = template, dir = None):
  439.     '''Create and return a temporary file.
  440.     Arguments:
  441.     \'prefix\', \'suffix\', \'dir\' -- as for mkstemp.
  442.     \'mode\' -- the mode argument to os.fdopen (default "w+b").
  443.     \'bufsize\' -- the buffer size argument to os.fdopen (default -1).
  444.     The file is created as mkstemp() would do it.
  445.  
  446.     Returns an object with a file-like interface; the name of the file
  447.     is accessible as file.name.  The file will be automatically deleted
  448.     when it is closed.
  449.     '''
  450.     if dir is None:
  451.         dir = gettempdir()
  452.     
  453.     if 'b' in mode:
  454.         flags = _bin_openflags
  455.     else:
  456.         flags = _text_openflags
  457.     if _os.name == 'nt':
  458.         flags |= _os.O_TEMPORARY
  459.     
  460.     (fd, name) = _mkstemp_inner(dir, prefix, suffix, flags)
  461.     file = _os.fdopen(fd, mode, bufsize)
  462.     return _TemporaryFileWrapper(file, name)
  463.  
  464. if _os.name != 'posix' or _os.sys.platform == 'cygwin':
  465.     TemporaryFile = NamedTemporaryFile
  466. else:
  467.     
  468.     def TemporaryFile(mode = 'w+b', bufsize = -1, suffix = '', prefix = template, dir = None):
  469.         '''Create and return a temporary file.
  470.         Arguments:
  471.         \'prefix\', \'suffix\', \'directory\' -- as for mkstemp.
  472.         \'mode\' -- the mode argument to os.fdopen (default "w+b").
  473.         \'bufsize\' -- the buffer size argument to os.fdopen (default -1).
  474.         The file is created as mkstemp() would do it.
  475.  
  476.         Returns an object with a file-like interface.  The file has no
  477.         name, and will cease to exist when it is closed.
  478.         '''
  479.         if dir is None:
  480.             dir = gettempdir()
  481.         
  482.         if 'b' in mode:
  483.             flags = _bin_openflags
  484.         else:
  485.             flags = _text_openflags
  486.         (fd, name) = _mkstemp_inner(dir, prefix, suffix, flags)
  487.         
  488.         try:
  489.             _os.unlink(name)
  490.             return _os.fdopen(fd, mode, bufsize)
  491.         except:
  492.             _os.close(fd)
  493.             raise 
  494.  
  495.  
  496.